Projects and Workspaces

Creating a Simple Project

To create a simple project go to File > Load Image File.

In the Load Image File(s) dialog box you can:

  1. Select multiple files by holding down the Shift or Ctrl keys.
  2. Access a list of recently accessed folders displays in the Go to Folder drop-down list. You can also paste a filepath into this field (which will also update the folder buttons at the top of the dialog box).

To later add additional image or thematic layers go to File > Add Data Layer in the main menu.

Creating a Project using the Source View dialog

The Source View dialog provides users a simple data management area to modify input layer alias, display orders and access information on file details.

To open the dialog choose View > Source View.

Select the Add input layer to project button to load data files, alternatively you can select the files in the Windows File Explorer and drag and drop them to the dialog to import them. You can add image layers, vector and point cloud layers to a new or existing project.

Furthermore, eCognition project (.dpr) and workspace (.dpj) files can be added by drag and drop.

This button deletes a selected data layer or a whole project (dependent on selection).

Source View dialog with project selected

The upper pane of the Source View dialog shows the project name, all data layers loaded, their alias and file paths. On selection of a project file or data file the lower pane shows different details and settings.

If you right click in the upper pane on the project name or a data file you can select one of the following options from the context menu:

 

The lower pane of the Source View dialog shows the following details

A) on selection of a project:

B)  on selection of a data file:

 

Use this option to add new maps to your project. Once you have added new maps, you can switch between their properties using the tabs at the bottom of this dialog.

Creating a Project with Predefined Settings

When you create a new project, the software generates a main map representing the image data of a scene. To prepare this, you select image layers and optional data sources like thematic layers or metadata for loading to a new project. You can rearrange the image layers, select a subset of the image or modify the project default settings. In addition, you can add metadata.

An image file contains one or more image layers. For example, an RGB image file contains three image layers, which are displayed through the Red, Green and Blue channels (layers).

Open the Create Project dialog box by going to File > New Project (for more detailed information on creating a project, refer to The Create Project Dialog Box). The Import Image Layers dialog box opens. Select the image data you wish to import, then press the Open button to display the Create Project dialog box.

File Formats

Opening certain file formats or structures requires you to select the correct driver in the File Type drop-down list.

Then select from the main file in the files area. If you select a repository file (archive file), another Import Image Layers dialog box opens, where you can select from the contained files. Press Open to display the Create Project dialog box.

The Create Project Dialog Box


Create Project dialog box

The Create Project dialog box gives you several options. These options can be edited at any time by selecting File > Modify Open Project:

In special cases you may want to ignore the unit information from the included geocoding information. To do so, deactivate Initialize Unit Conversion from Input File item in Tools > Options in the main menu

Geocoding and Projection

Geocoding

Geocoding is the assignment of positioning marks in images by coordinates. Typically, available geocoding information is automatically detected: if not, you can enter coordinates manually. Images without geocodes create automatically a virtual coordinate system with a value of 0/0 at the upper left and a unit of 1 pixel. For such images, geocoding represents the pixel coordinates instead of geographic coordinates.


The Layer Properties dialog box allows you to assign geocoding information

eCognition can reproject raster image layers and vector layers. If the coordinate system is supported, coordinates from inserted files are detected automatically. If the information is not included in the image file but is nevertheless available, you can edit it manually.

After importing a layer in the Create New Project or Modify Existing Project dialog boxes, double-click on a layer to open the Layer Properties dialog box. To edit geocoding information, select the Geocoding check box. You can edit the following:

Assign Projection

If the coordinate system of a dataset is unknown or incorrect you can use this tool to assign a projection (Tools> Assign Projection), under the precondition that you know the projection information.

Existing information on the coordinate system stored in the dataset will be overwritten. This tool does not reproject data and or perform any calculations. To reproject data open the dialog Tools > Reproject Data.

Supported data formats are tif for image data, shapefile for vector data and point clouds in LAS and LAZ formats.

Assign Projection tool dialog

 

First step is to add the data to the dialog by clicking the Load button.

Load button

Following information is displayed for each file:

To remove a data file from the list, select the file and press the Remove button. To remove all files from the list, press the Remove All button. These two functionalities do not delete the file, the file will be just unloaded from the list of this Assign Projection dialog.

Remove and Remove All buttons

The target coordinate system (Target CS) can be selected or searched from the drop-down list . To search for a coordinate system, start typing a name or an EPSG code of a coordinate system in the field. Alternatively, a target coordinate system can be loaded via file using the From File button to the right of the drop-down.

Defining a target coordinate system

The target coordinate system must be a projected coordinate system. Supported input formats are tif, shp, LAS/LAZ (see also Reprojection tool in following chapter).

In the Output folder field, the path for files with assigned projection is displayed: by default they are located in a subfolder of the data folder called Processed. (If the data is located in different folders, the default path is the folder of the first loaded dataset). However, you can define the ouput folder using the Browse button or type directly into the Output folder field.

Output path for files with assigned projection

 

To assign the new projection to the loaded input files, press the Execute button. Then a progress bar appears on the screen indicating the status of processing. When the projection assignment is done an output path appears next to each file in the dialog.

Reproject

For image analysis in eCognition Developer, the data used must belong to the same projected coordinate system. Geographic coordinate systems have different pixel size in X and Y axes resulting in non-square pixels which should be avoided.

This reprojection tool can be used for reprojecting data from a geographic coordinate system to a projected coordinate system or from one projected coordinate system to another if the data are defined on different systems or if you need the results in a coordinate system different from the one of the input data.

To reproject data select Tools > Reproject Data.

Supported data formats are tif for image data and shapefile format for vector data.

Use the Load button to add the data to the Reproject data dialog.

Load button

In the dialog you get the following information for each file:

To remove a data file from the list, select the file and press the Remove button. To remove all files from the list, press the Remove All button. These two functionalities do not delete the file, the file will be just unloaded from the list of the Reproject dialog.

Remove and Remove All buttons

The target coordinate system (Target CS) can be selected or searched from the drop-down list. To search for a coordinate system, start typing a name or an EPSG code of a coordinate system in the field. Alternatively, a target coordinate system can be loaded via file using the From File button to the right of the drop-down.

The target coordinate system must be a projected coordinate system. Supported data formats are TIF for image data and shapefile for the vector data.

Defining a target coordinate system

 

In the Output folder field, the path for reprojected files is displayed: by default they are located in a subfolder of the data folder called Reprojected. (If the data is located in different folders, the default path is the folder of the first loaded dataset). However, you can define the ouput folder using the Browse button or type directly into the Output folder field.

Output path to the reprojected files

To reproject the loaded input files press the Execute button.

Execute reprojection or close the dialog

Then a progress bar appears indicating the status of processing. Once the reprojection is applied an output path appears next to each file in the dialog window.

Progress bar

If you add image layers or thematic layers to a project, that are assigned to a geographic coordinate syste, a warning message is prompted that it is recommend to reproject the data. Select one of the following options:

Assigning No-Data Values


The Assign No Data Values Dialog Box

No-data values can be assigned to scenes with two dimensions only. This allows you to set the value of pixels that are not to be analyzed. Only no-data-value definitions can be applied to maps that have not yet been analyzed.

No-data values can be assigned to image pixel values (or combinations of values) to save processing time. These areas will not be included in the image analysis. Typical examples for no-data values are bright or dark background areas. The Assign No Data Value dialog box can be accessed when you create or modify a project.

After preloading image layers press the No Data button. The Assign No Data Values dialog box opens:

Importing Image Layers of Different Scales

You can insert image layers and thematic layers with different resolutions (scales) into a map. They need not have the same number of columns and rows. To combine image layers of different resolutions (scales), the images with the lower resolution – having a larger pixel size – are resampled to the size of the smallest pixel size. If the layers have exactly the same size and geographical position, then geocoding is not necessary for the resampling of images.


Left: Higher resolution – small pixel size. Right: Lower resolution – image is resampled to be imported

Editing Multidimensional Map Parameters

When creating a new map, you can check and edit parameters of multidimensional maps that represent time series. Typically, these parameters are taken automatically from the image data set and this display is for checking only. However in special cases you may want to change the number, the distance and the starting item of frames. The preconditions for amending these values are:

To open the edit multidimensional map parameters, create a new project or add a map to an existing one. After preloading image layers press the Edit button. The Layer Properties dialog box opens.

Editable parameters are listed in the following table - Multidimensional Map Parameters:

Parameter Description Calc button Default
Number of frames The number of two-dimensional images each representing a single film picture (frame) of a scene with time dimension. Click the Calc button to calculate the rounded ratio of width and height of the internal map. 1
Frame distance Change the temporal distance between frames. (no influence) 1
Frame start Change the number of the first displayed frame. (no influence) 0

Confirm with OK and return to the previous dialog box. After the a with a new map has been created or saved, the parameters of multidimensional maps cannot be changed any more.

Multisource Data Fusion

If the loaded image files are geo-referenced to one single coordinate system, image layers and thematic layers with a different geographical coverage, size, or resolution can be inserted.

This means that image data and thematic data of various origins can be used simultaneously. The different information channels can be brought into a reasonable relationship to each other.


Layers with different geographical coverage

 

Creating, Saving and Loading Workspaces

The Workspace window lets you view and manage all the projects in your workspace, along with other relevant data. You can open it by selecting View > Windows > Workspace from the main menu.


Workspace window with Summary and Export Specification and drop-down view menu

The Workspace window is split in two panes:

In List View and Folder View, information is displayed about a selected project – its state, scale, the time of the last processing and any available comments. The Scale column displays the scale of the scene. Depending on the processed analysis, there are additional columns providing exported result values.

Opening and Creating New Workspaces

To open a workspace, go to File > Open Workspace in the main menu. Workspaces have the .dpj extension. This function uses the same customized dialog as described for loading an image file (Creating a Simple Project).

Alternatively you can select workspace (.dpj) or project (.dpr) files in the Windows File Explorer and drag and drop them to the workspace window to import them.


The Open Workspace dialog box

To create a new workspace, select File > New Workspace from the main menu or use the Create New Workspace button on the default toolbar. The Create New Workspace dialog box lets you name your workspace and define its file location – it will then be displayed as the root folder in the Workspace window.

If you need to define another output root folder, it is preferable to do so before you load scenes into the workspace. However, you can modify the path of the output root folder later on using File > Workspace Properties.

User Permissions

The two checkboxes at the bottom left of the Open Workspace dialog box determine the permissions of the user who opens it.

If a Project Edit user opens a workspace before a full user, the Workspace view will display the status ‘locked’. Users can use the Project History function to show all modifications made by other users.

Multiple access is not possible in Data Management mode. If a workspace is opened using an older software version, it cannot be opened with eCognition Developer at the same time.

Importing Scenes into a Workspace


Import Scenes dialog box

Before you can start working on data, you must import scenes in order to add image data to the workspace. During import, a project is created for each scene. You can select different predefined import templates according to the image acquisition facility producing your image data.

If you only want to import a single scene into a workspace, use the Add Project command. To import scenes to a workspace, choose File > Predefined Import from the main menu or right-click the left-hand pane of the Workspace window and choose Predefined Import. (By default, the connectors for predefined import are stored in the installation folder under \bin\drivers\import. If you want to use a different storage folder, you can change this setting under Tools > Options > General.)

The Import Scenes dialog box opens:

  1. Select a predefined template from the Import Template drop-down box
  2. Browse to open the Browse for Folder dialog box and select a root folder that contains image data
  3. The subordinate file structure of the selected image data root folder is displayed in the Preview field. The plus and minus buttons expand and collapse folders
  4. Click OK to import scenes. The tree view on the left-hand pane of the Workspace window displays the file structure of the new projects, each of which administrate one scene.


Folder structure in the Workspace window

Supported Import Templates

You can use various import templates to import scenes. Each import template is provided by a connector. Connectors are available according to which edition of the eCognition Server you are using.

A full list of supported and generic image formats is available in Supported Raster and Vector Formats

Generic Import Templates

Import Template (Connector) Description File Formats File Based? Windows Linux
Generic – one file per scene A scene may consist of multiple image layers. All image layers are saved to one file All Yes Yes Yes
Generic – one scene per folder All files that are found in a folder will be loaded to one scene All Yes Yes Yes

Generic import templates may support additional instruments or image readers not listed here. For more information about unlisted import templates contact Trimble via https://support.ecognition.com/

About Generic Import Templates

Image files are scanned into a workspace with a specific method, using import templates, and in a specific order according to folder hierarchy. This section lists principles of basic import templates used for importing scenes within the Import Scenes dialog box.

Options

Images are scanned in a specific order in the preview or workspace. There are two options:

  1. Select the check-box Search in Subfolders:
    • Files in selected folder and all subfolders
    • Takes the first item in current folder
    • If this item is a folder, then steps into this folder and continues search there.
  2. Clear the check-box Search in Subfolders:
    • Only files directly in the folder
    • Alphabetical ascending
      For example, one might import the following images with this folder structure:
      • [selected folder] > [1] > [5] > 1.tif & 8.tif
      • [selected folder] > [1] > [8] > 5.tif
      • [selected folder] > [1] > 3.tif & 7.tif
      • [selected folder] > [3] > 6.tif
      • [selected folder] > 2.tif & 4.tif

Predefined Import Templates

Available predefined import templates

Configuring the Workspace Display

eCognition Developer offers several options for customizing the Workspace.


Context menu in Workspace information pane


Modify Column Dialog Box

To select what information is displayed in columns, right-click in the pane to display the context menu.

  1. Expand All Columns will auto fit the columns to the width of the pane. If this is selected, the menu will subsequently display the Collapse All Menus option.
  2. Selecting Insert Column or Modify Column displays the Modify Column dialog box:
    • In Type, select the column you wish to display
    • In Name, enter the text to appear in the heading
    • In Width, select the width in pixels
    • In Alignment, choose between left, right and center
    • Press OK to confirm. You can change the position of a column by dragging it with the mouse.
  3. Select Delete Column to get rid of a column
  4. Modify Views launches the Edit Views dialog box, which lets you save a particular view.
    • Use the buttons to add or delete views
    • Selecting Add launches the Add New View dialog box. Enter the name of your custom view and select the view on which you wish to base it in the Copy Columns From field.


Edit Views Dialog Box (selecting Add launches Add New View)